mkvdiskhostmap
mkvdiskhostmap コマンドは、ボリュームとホストの間に新しいマッピングを作成するために使用します。これにより、指定したホストからそのボリュームにアクセスして、入出力 (I/O) 操作を行うことができるようになります。
構文
パラメーター
- -force
- (オプション) 通常は許可されていない、ボリュームからホストへの複数割り当てを許可します。
- -host host_id | host_name
- (必須) ボリュームのマップ先のホストを ID または名前のいずれかで指定します。
- -scsi scsi_num_arg
- (オプション) 指定のホスト上でこのボリュームに割り当てる SCSI 論理装置番号 (LUN) ID を指定します。scsi_num_arg パラメーターには、ボリュームへのアクセス権限を提供しているすべての入出力グループで指定のホスト上のボリュームに割り当てられる SCSI LUN ID が入ります。ホスト・システムをチェックして、指定のホスト・バス・アダプター (HBA) 上で次に使用可能な SCSI LUN ID を確認する必要があります。-scsi パラメーターを指定しない場合、アクセス権限を提供する各入出力グループ内で次に使用可能な SCSI LUN ID がホストに提供されます。-scsi パラメーターは、NVMe ホストではサポートされていません。NVMe プロトコルを使用するホストにボリュームがマップされると、システムによってボリューム名前空間 ID (NSID) が割り当てられます。 このパラメーターは、-allowmismatchedscsiids と同時に指定できません。
- -allowmismatchedscsiids
- (オプション) 新しいホスト・マッピングを作成するときに、このパラメーターを指定すると、システムは、ボリュームのアクセス入出力グループで同一でない SCSI LUN ID を割り振ることができます。このパラメーターを -scsi と同時に指定することはできません。
- vdisk_name | vdisk_id
- (必須) ホストにマップするボリュームを ID または名前で指定します。
説明
このコマンドは、ボリュームと指定のホスト間の新規のマッピングを作成します。ホストには、ボリュームは、ディスクが直接ホストに接続している場合と同様に見えます。このコマンドが処理された後に、ホストはボリュームに対して入出力トランザクションを実行できるようになります。
オプションで、SCSI LUN ID を SCSI ホストのマッピングに割り当てることができます。ホストの HBA は、ホストに接続された装置をスキャンする際に、ホストのファイバー・チャネル・ポートにマップされたすべてのボリュームを発見します。装置が見つかると、それぞれの装置に ID (SCSI LUN ID) が割り振られます。例えば、最初に検出されたディスクには SCSI LUN 0、などが割り振られます。必要な場合、SCSI LUN ID を割り当てることによって、HBA がボリュームをディスカバーする順序を制御できます。SCSI LUN ID を指定しない場合、そのホストにすでにマッピングが存在すれば、クラスターが自動的に次の有効な SCSI LUN ID を割り当てます。mkvdiskhostmap コマンドを発行すると、割り当てられた SCSI LUN ID 番号が返されます。
NVMe の場合、SCSI LUN ID は無関係であるため、システムは代わりに NSID を割り当てます。NSID は変更することができません。NVMe ボリュームへのマッピングを作成すると、NSID が返されます (NSID は vdisk_ID + 1 です)。
- このマッピングが作成されている対象のホストが、ボリューム・アクセス・セット内のどの入出力グループとも関連付けられていない
- ボリュームが、アクセス・セット内に複数の入出力グループを持っており、ボリュームにマップされているホストが、複数の入出力グループからマッピングされているボリュームをサポートしていない
- ホスト・プロトコルがボリューム・プロトコルと非互換である
- ボリュームに複数のアクセス入出力グループがあり、ホスト・プロトコルが NVMe である
- すべてのアクセス入出力グループで同一の SCSI LUN ID を使用できない場合、コマンドが失敗する
SCSI LUN ID を指定しない場合、システムは、すべてのアクセス入出力グループで最も低い共通の SCSI LUN ID を割り当てようとします。返される ID は、ボリュームがマップされたすべての入出力グループで同じです。
システムがアクセス入出力グループで同一でない SCSI LUN ID を割り振ることを許可するには、-allowmismatchedscsiids パラメーターを使用します。各アクセス入出力グループで使用できる最も低い値が使用されます。すべてのアクセス入出力グループで同じにならない場合があります。ホストがこの構成をサポートしていることを確認してください。このパラメーターは、-scsi パラメーターと一緒に使用できず、NVMe ホストではサポートされていません。NVMe プロトコルを使用するホストにボリュームがマップされると、システムによってボリューム名前空間 ID (NSID) が割り当てられます。
異なる SCSI LUN ID を生成した場合、返されるのは 1 つのみです。返される ID は、ボリュームがマップされたいた入出力グループのうち、最も大きい番号の入出力グループの ID です。他の値を表示するには、lshostvdiskmap または lsvdiskhostmap を発行します。
SCSI LUN ID は、ボリュームがマップされている入出力グループのうち、もっとも大きい番号の入出力グループのものが使用されます。
- ボリューム 1 が、SCSI LUN ID 1 をもつホスト 1 にマップされている。
- ボリューム 2 が、SCSI LUN ID 2 をもつホスト 1 にマップされている。
- ボリューム 3 が、SCSI LUN ID 4 をもつホスト 1 にマップされている。
ID 3 にマップされた SCSI LUN がないため、デバイス・ドライバーが HBA をスキャンする際にボリューム 1 と 2 を識別した後に停止します。パフォーマンスを最適にするには、必ず SCSI LUN ID の割り振りが連続するようにしてください。
mkvdiskhostmap -host host1 -force 4 mkvdiskhostmap -host host2 -force
4 これらのコマンドは、ボリューム 4 について、ホストからボリュームへのマッピングを 2 つ (host1 と host2 へのマップ) 作成します。既にボリュームがホストにマップされている場合は、-force パラメーターを省略するとマッピングが失敗します。
(このマッピングの対象である) ホスト・オブジェクトが、ボリュームが属する入出力グループに関連付けられていない場合も、コマンドは失敗します。
- マッピングは構成の目的で作成されます (変更または削除が可能です)
- 2 次ボリュームはホストに提示されません
- ホスト・タイプが hide_secondary 以外のタイプに変更された
- -access を指定することによってリモート・コピー関係が停止された
- リモート・コピー関係が削除されたか切り替えられたために、ボリュームが 2 次ボリュームではなくなった
アクティブ/アクティブ関係における補助ボリュームである場合や、あらゆるタイプの関係における変更ボリュームである場合、このコマンドを指定することはできません。呼び出し例
mkvdiskhostmap -host host1 -scsi 1 5結果出力:
Virtual Disk to Host map, id [1], successfully created